Changes

This PR updates the Management API code with several improvements:

Authentication & Client Options:

• Refactored internal authentication to use AuthProvider abstraction pattern
• Added logging option to client configuration for debugging
• These are internal implementation changes - the wrapper and user-facing API remain unchanged

Error Handling:

• Enhanced error classes with proper prototype chain using new.target.prototype
• Added stack trace capture with Error.captureStackTrace for better debugging
• Centralized non-status-code error handling via handleNonStatusCodeError

Pagination:

• Fixed pagination logic with Math.floor() for page size calculations
• Simplified page offset increment logic

Internal Refactoring:

• Renamed internal client classes with Client suffix (e.g., Actions → ActionsClient)
• Simplified header merging by replacing mergeOnlyDefinedHeaders with mergeHeaders
• Updated Jest configuration with proper TypeScript config paths and setup files

Other:

• SDK version bumped from 5.0.0 to 5.1.0
• Various dependency updates

Note: All changes are internal implementation details. The ManagementClient wrapper and user-facing API remain unchanged.

Logging Examples

The new logging option allows you to configure debug logging for API requests:

Enable debug logging with default console logger:

import { ManagementClient } from 'auth0';

const client = new ManagementClient({
  domain: 'your-tenant.auth0.com',
  clientId: 'your-client-id',
  clientSecret: 'your-client-secret',
  logging: {
    level: 'debug',  // 'debug' | 'info' | 'warn' | 'error'
    silent: false    // Set to false to enable logging output
  }
});

Use a custom logger implementation:

import { ManagementClient } from 'auth0';

const customLogger = {
  debug: (msg, ...args) => myLogger.debug(msg, args),
  info: (msg, ...args) => myLogger.info(msg, args),
  warn: (msg, ...args) => myLogger.warn(msg, args),
  error: (msg, ...args) => myLogger.error(msg, args),
};

const client = new ManagementClient({
  domain: 'your-tenant.auth0.com',
  clientId: 'your-client-id',
  clientSecret: 'your-client-secret',
  logging: {
    level: 'info',
    logger: customLogger,
    silent: false
  }
});

References

• Automated SDK regeneration from API definition updates

Testing

• This change adds unit test coverage
• This change adds integration test coverage

Existing tests updated to work with the new configuration patterns (e.g., maxRetries: 0 added to test clients).

Checklist

• I have read the Auth0 general contribution guidelines
• I have read the Auth0 Code of Conduct
• All existing and new tests complete without errors